home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / src / exampleCode / opengl / utilities / xglinfo / README < prev    next >
Text File  |  1996-11-11  |  6KB  |  146 lines

  1.  
  2.        ~4Dgifts/toolbox/src/exampleCode/opengl/utilities/xglinfo README
  3.  
  4.             (this file was created by doing "nroff -ms xglinfo.man")
  5.  
  6.  
  7.  
  8.  
  9.          
  10.          xglinfo - display & visual information  utility  for  OpenGL
  11.          with the X Window System
  12.          
  13.          xglinfo    [-display    displayname]    [+-printDisplayInfo]
  14.          [+-printScreenInfo]    [+-printVisualInfo]   [+-printCooked-
  15.          VisualInfo] [+-printRawVisualInfo]
  16.          
  17.          
  18.          
  19.               Xglinfo is a utility for displaying  information  about
  20.          an X server supporting the OpenGL extension, especially with
  21.          regards to visuals.  It is used to examine the  capabilities
  22.          of  a  server,  the predefined values for various parameters
  23.          used in communicating between clients and  the  server,  and
  24.          the  different  types of screens and visuals that are avail-
  25.          able. It includes the same set of information  as  xdpyinfo,
  26.          but  is extended to display information about OpenGL visuals
  27.          as well. In contrast to xdpyinfo  the  amount  and  form  of
  28.          information  displayed is controllable by command line argu-
  29.          ments.
  30.          
  31.               The amount of information displayed is controllable  by
  32.          the  command  line  switches.  Many  of  these switches take
  33.          either a '+' or a '-'. If the argument is preceded by a  '+'
  34.          the  option  is  turned on. If the argument is preceded by a
  35.          '-' the option is turned off.
  36.          
  37.               The visual information can be printed in  either  'raw'
  38.          or  'cooked'  form.  The  cooked form is the default. In the
  39.          cooked form  the  visual  information  is  analyzed  and  is
  40.          presented in user friendly form. At the same time some basic
  41.          error checks are performed on  the  combinations  of  visual
  42.          data.  The  raw  form just dumps the values returned for the
  43.          visual.
  44.          
  45.               Credit is due to Jim  Fulton  who  wrote  the  original
  46.          xdpyinfo while at MIT from which xglinfo is derived.
  47.          
  48.          
  49.               The following shows a sample produced by  xglinfo  when
  50.          connected  to display that supports an 24 plane screen. Note
  51.          the error reporting for the OpenGL visuals. The inconsistent
  52.          OpenGL  visuals  were  deliberately set up to illustrate the
  53.          error checking feature.
  54.          
  55. ================================= Display :0.0 =================================name of display:        :0.0
  56. version number:         11.0
  57. vendor string:          DECWINDOWS Digital Equipment Corporation DEC OSF/1 V1.2
  58. vendor release:         1
  59. max request size:       262140 bytes
  60. motion buffer size:     100
  61. bitmap:                 unit = 32, bit order = LSBFirst, padding = 32
  62. image byte order:       LSBFirst
  63. keycode range:          minimum 86, maximum 255
  64. focus:                  PointerRoot
  65. default screen num:     0
  66. number of screens:      1
  67. pixmap formats:         4 total
  68.                         depth  1, bits_per_pixel  1, scanline_pad 32
  69.                         depth  8, bits_per_pixel  8, scanline_pad 32
  70.                         depth 12, bits_per_pixel 16, scanline_pad 32
  71.                         depth 24, bits_per_pixel 32, scanline_pad 32
  72. Server Extensions:      14 total
  73.                         X3D-PEX, GLX, DEC-GLX, SHAPE, MIT-SHM,
  74.                         Multi-Buffering, MIT-SUNDRY-NONSTANDARD,
  75.                         Keyboard-Management-Extension,
  76.                         Shared-Memory Transport, DEC-XTRAP, XVideo, Xie,
  77.                         Adobe-DPS-Extension, DPSExtension,
  78. GLX Extension:          error base = 142, event base = 64, Version 1.0
  79. =================================== Screen 0 ===================================screen:                 0
  80. dimensions:             1280x1024 pixels (342x273 millimeters)
  81. resolution:             95x95 dots per inch
  82. depths:                 (3 total):       1, 8, 24
  83. root window id:         0x2a
  84. depth of root window:   24 planes
  85. number colormaps:       minimum 1, maximum 1
  86. default colormap:       0x28, number colormap cells 256
  87. preallocated pixels:    black 0x0, white 0xffffff
  88. options:                backing-store YES, save-unders YES
  89. input event mask:       0x70003c
  90.                         ButtonPress          ButtonRelease        EnterWindow
  91.                         LeaveWindow          SubstructureRedirect FocusChange
  92.                         PropertyChange
  93. =================== 7 Visuals for Screen 0 (default = 0x26) ===================
  94. StaticGray visual: ID = 0x21 (hex) 33 (decimal) screen = 0
  95.   GL NOT SUPPORTED
  96.   Core X: depth=8, colormapSize=256
  97.  
  98. GrayScale visual: ID = 0x22 (hex) 34 (decimal) screen = 0
  99.   GL NOT SUPPORTED
  100.   Core X: depth=8, colormapSize=256
  101.  
  102. StaticColor visual: ID = 0x23 (hex) 35 (decimal) screen = 0
  103.   DOUBLE buffered MONO COLOR INDEX visual with (Z Stencil)
  104.   GL Sizes: ColorIndex=8, Z=24, Stencil=8
  105.   ERROR: CI visual, but Alpha has non-zero size = 8
  106.   Core X: depth=8, colormapSize=256
  107.  
  108. PseudoColor visual: ID = 0x24 (hex) 36 (decimal) screen = 0
  109.   DOUBLE buffered MONO COLOR INDEX visual with (Z Stencil)
  110.   GL Sizes: ColorIndex=8, Z=24, Stencil=8
  111.   ERROR: CI visual, but Alpha has non-zero size = 8
  112.   Core X: depth=8, colormapSize=256
  113.  
  114. TrueColor visual: ID = 0x25 (hex) 37 (decimal) screen = 0
  115.   DOUBLE buffered MONO RGB visual with (Alpha Z Stencil Accum)
  116.   GL Sizes: RGBA=(3,3,2,8), Z=24, Stencil=8, Accum=(16,16,16,16)
  117.   Core X: depth=8, colormapSize=8 RGB: masks=(0xe0,0x1c,0x3) bits=8
  118.  
  119. TrueColor visual: ID = 0x26 (hex) 38 (decimal) screen = 0
  120.   DOUBLE buffered MONO RGB visual with (Alpha Z Stencil Accum)
  121.   GL Sizes: RGBA=(8,8,8,8), Z=24, Stencil=8, Accum=(16,16,16,16)
  122.   Core X: depth=24, colormapSize=256 RGB: masks=(0xff0000,0xff00,0xff) bits=8
  123.  
  124. DirectColor visual: ID = 0x27 (hex) 39 (decimal) screen = 0
  125.   DOUBLE buffered MONO RGB visual with (Alpha Z Stencil Accum)
  126.   GL Sizes: RGBA=(8,8,8,8), Z=24, Stencil=8, Accum=(16,16,16,16)
  127.   Core X: depth=24, colormapSize=256 RGB: masks=(0xff0000,0xff00,0xff) bits=8
  128.  
  129.  
  130.  
  131.  
  132.          DISPLAY To get the default host, display number, and screen.
  133.          
  134.          X(1), xdpyinfo(1), xwininfo(1), xprop(1), xrdb(1)
  135.          
  136.          Copyright 1993, Digital Equipment Corporation
  137.          
  138.          John Dennis
  139.          Digital Equipment Corporation
  140.          jdennis@mlo.dec.com
  141.          
  142.          
  143.          
  144.          
  145.                                October 22, 1993
  146.